home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / comm / frx11.zip / RXFER.DOC < prev    next >
Text File  |  1992-04-03  |  45KB  |  1,051 lines
  1.  
  2.  
  3.                        ┌──────────────────────────────────────┐
  4.                        │                                      │
  5.                        │              Transfer Log Processor  │
  6.                        │  ┬─┬─────┐   For Robocomm 4.x (tm)   │
  7.                        │  │ │     │                           │
  8.                        │  │ ├───┬─┘           FREEWARE!!      │
  9.                        │  │ │   │           For Registered    │
  10.                        │  ┴─┴   ┴──         Robocomm Users    │
  11.                        │           ┐     ┌                    │
  12.                        │            └┐ ┌┘                     │
  13.                        │              ┼    ┬┬──┐ ┬┬──┐ ┬┬──┐  │
  14.                        │            ┌┘ └┐  │├─   │├─   │├─┬┘  │
  15.                        │           ┘     └ ┴┴    ┴┴──┘ ┴┴ ┴─  │
  16.                        │                                      │
  17.                        │            Version 1.10              │
  18.                        └──────────────────────────────────────┘
  19.                        ┌──────────────────────┐
  20.                        │         RXfer        │
  21.                        │  Copyright (c) 1992  │
  22.                        │      Ron Eisner      │
  23.                        └──────────────────────┘
  24.  
  25.  
  26.     Freeware RXfer
  27.      Copyright (c) 1992 Ronald J. Eisner
  28.      ___________________________________________________________________________
  29.  
  30.  
  31.      TABLE OF CONTENTS
  32.      -----------------
  33.  
  34.  
  35.      DISCLAIMER OF WARRANTY  . . . . . . . . . . . . . . iii
  36.  
  37.      LIMITS OF LIABILITY . . . . . . . . . . . . . . . . iii
  38.  
  39.      LICENSE AGREEMENT . . . . . . . . . . . . . . . . .  iv
  40.  
  41.      WHAT IS RXFER?  . . . . . . . . . . . . . . . . . .   v
  42.  
  43.      PROGRAM FEATURES  . . . . . . . . . . . . . . . . .  vi
  44.  
  45.      PROGRAM REQUIREMENTS  . . . . . . . . . . . . . . .  vi
  46.  
  47.      DISTRIBUTION FILE LIST  . . . . . . . . . . . . . . vii
  48.  
  49.      INSTALLATION  . . . . . . . . . . . . . . . . . . .   1
  50.  
  51.      PROGRAM CONFIGURATION . . . . . . . . . . . . . . .   1
  52.  
  53.      AUTOMATIC TRANSFER.LOG PROCESSING . . . . . . . . .   2
  54.  
  55.      LOOKING UP FILE TRANSFERS . . . . . . . . . . . . .   3
  56.  
  57.      LOOKING UP FILE TRANSFERS BY FILENAME . . . . . . .   3
  58.  
  59.      THE FILE ACTIVITY TABLE . . . . . . . . . . . . . .   3
  60.  
  61.      THE LOCATOR . . . . . . . . . . . . . . . . . . . .   4
  62.  
  63.      USING THE LOCATOR . . . . . . . . . . . . . . . . .   4
  64.           FINDING FILES WITH THE LOCATOR . . . . . . . .   5
  65.  
  66.      DELETING CHARACTERS FROM THE LOCATOR  . . . . . . .   5
  67.  
  68.      LOOKING UP FILE TRANSFERS BY BBS  . . . . . . . . .   6
  69.  
  70.      EXPORTING DATA  . . . . . . . . . . . . . . . . . .   6
  71.  
  72.      QUITTING RXFER  . . . . . . . . . . . . . . . . . .   7
  73.  
  74.      TECHNICAL SUPPORT . . . . . . . . . . . . . . . . .   8
  75.  
  76.      NEW VERSION AVAILABILITY  . . . . . . . . . . . . .   9
  77.  
  78.      SHAREWARE RXFER PLUS  . . . . . . . . . . . . . . .  10
  79.  
  80.      INDEX . . . . . . . . . . . . . . . . . . . . . . .  12
  81.  
  82.     Freeware RXfer                                                          iii
  83.      Copyright (c) 1992 Ronald J. Eisner
  84.      ___________________________________________________________________________
  85.  
  86.  
  87.      DISCLAIMER OF WARRANTY
  88.      ----------------------
  89.  
  90.  
  91.      THIS SOFTWARE AND ANY ACCOMPANYING MATERIALS AND OR FILES (SUCH AS DOCUMEN-
  92.      TATION OR SAMPLE DATA) ARE DISTRIBUTED "AS IS" AND WITHOUT WARRANTIES AS TO
  93.      PERFORMANCE OF MERCHANTABILITY OR ANY OTHER WARRANTIES WHETHER EXPRESSED OR
  94.      IMPLIED.  BECAUSE OF THE VARIOUS HARDWARE AND SOFTWARE ENVIRONMENTS INTO
  95.      WHICH THIS PROGRAM MAY BE PUT, NO WARRANTY OF FITNESS FOR A PARTICULAR
  96.      PURPOSE IS OFFERED.
  97.  
  98.  
  99.  
  100.      LIMITS OF LIABILITY
  101.      -------------------
  102.  
  103.  
  104.      FREEWARE RXFER, IN ALL OF ITS RELEASES, IS COMPUTER SOFTWARE AND AS SUCH
  105.      MAY CONTAIN BUGS AND/OR FLAWS THAT CAUSE THE PROGRAM TO PERFORM OTHER THAN
  106.      INTENDED.  INDEED, THE PROGRAM MAY CONTAIN FLAWS THAT CAUSE DAMAGE TO YOUR
  107.      SYSTEM AND/OR DATA STORED ON YOUR SYSTEM.  WHILE A GOOD FAITH EFFORT HAS
  108.      BEEN EXPENDED TO ELIMINATE ANY AND ALL DAMAGING BUGS AND FLAWS, AND NONE
  109.      ARE KNOWN TO EXIST, THERE IS NO GUARANTEE THAT SUCH BUGS AND FLAWS DO NOT
  110.      EXIST.  THE USER MUST THEREFORE ASSUME THE ENTIRE RISK OF USING THE
  111.      PROGRAM.  NO LIABILITY IS ASSUMED BY THE AUTHOR OR ANY AUTHORIZED SELLER
  112.      AND/OR DISTRIBUTOR OF THIS SOFTWARE.
  113.  
  114.     Freeware RXfer                                                           iv
  115.      Copyright (c) 1992 Ronald J. Eisner
  116.      ___________________________________________________________________________
  117.  
  118.  
  119.      LICENSE AGREEMENT
  120.      -----------------
  121.  
  122.  
  123.           1:   Freeware RXfer is distributed as FREEWARE.  FREEWARE is NOT
  124.                PUBLIC DOMAIN!  Freeware is legally copyrighted and protect-
  125.                ed software distributed at no charge to the end user.
  126.  
  127.           2:   You are licensed to use Freeware RXfer on as many systems as
  128.                you desire.  You may simultaneously use multiple copies of
  129.                Freeware RXfer on single or multiple systems.
  130.  
  131.           3:   You MUST be a REGISTERED user of Robocomm.
  132.  
  133.                a:   You CANNOT modify the RXfer executable to
  134.                     bypass the check for a registered copy of
  135.                     Robocomm.
  136.  
  137.           4:   You are allowed to distribute Freeware RXfer as described
  138.                below:
  139.  
  140.                a:   You may only distribute UNMODIFIED COPIES of Freeware
  141.                     RXfer files.
  142.  
  143.                b:   You MUST distribute ALL of the files listed in the
  144.                     DISTRIBUTION FILE LIST, page vii, below, and ONLY those
  145.                     files.  You may, however, add or replace the archive
  146.                     description - but the author's description is pre-
  147.                     ferred.  (Note that you must include FILE_ID.DIZ and
  148.                     DESC.SDI in your distribution as they are listed in the
  149.                     DISTRIBUTION FILE LIST.)
  150.  
  151.                c:   You are allowed to distribute Freeware RXfer freely
  152.                     among BBS systems.
  153.  
  154.                d:   You may add Freeware RXfer to a User Group library as
  155.                     long as no fee is charged for the ability of the
  156.                     Freeware RXfer archive to be "checked out" of said
  157.                     library.
  158.  
  159.                e:   You are NOT allowed to charge any fee for the distribu-
  160.                     tion of Freeware RXfer without the express written
  161.                     consent of the legal copyright holder, Ron Eisner.
  162.                     Normal BBS membership fees are not considered to be
  163.                     distribution fees.
  164.  
  165.     Freeware RXfer                                                            v
  166.      Copyright (c) 1992 Ronald J. Eisner
  167.      ___________________________________________________________________________
  168.  
  169.  
  170.      WHAT IS RXFER?
  171.      --------------
  172.  
  173.  
  174.        FREEWARE RXFER is a Robocomm (tm) TRANSFER.LOG processor.  It will read
  175.      your TRANSFER.LOG and allow you to look up information about your file
  176.      transfers.  It maintains two databases - "FILE TRANSFER" (filename
  177.      XFERFILE.DAT) and "BBS" (filename XFERBBS.DAT).  The file transfer database
  178.      contains one record for each line in the Robocomm TRANSFER.LOG file.  The
  179.      BBS database contains one record for each unique BBS found in the file
  180.      transfer records.
  181.  
  182.        With these two databases, you can look up any file and see all of the
  183.      BBS's it has been transferred from or to.  Or, you can look up a specific
  184.      BBS and see all of the file transfers that have taken place with that
  185.      system.
  186.  
  187.        RXFER is primarily a tool to help you determine to what systems you
  188.      should upload particular files.  If your memory is as short as the
  189.      author's, you frequently cannot remember to which BBS's a file has been
  190.      uploaded.  Consequently, you may create upload agendas that duplicate past
  191.      efforts.
  192.  
  193.        Robocomm performs a duplicate file check on a system prior to executing
  194.      an upload agenda item.  Thus, it is not likely that your duplicate upload
  195.      agenda item will actually result in uploading a file to a single system
  196.      more than once (unless the BBS converts your archive format to a different
  197.      one - resulting in the failure of Robocomm's duplicate file check).
  198.      However, you will have wasted valuable time constructing the agenda.
  199.  
  200.        In addition, if you have forgotten to which systems you have uploaded
  201.      particular files, you will likely also have forgotten some of the files
  202.      that have NOT been uploaded to certain BBS's.  Thus, you will likely miss
  203.      good upload candidates.
  204.  
  205.        Rather than blindly construct upload agendas that may contain files
  206.      already uploaded to a particular system or may not contain files that COULD
  207.      be uploaded to a system, you can use RXFER to see exactly what BBS's have
  208.      received an upload candidate.  This information allows you to construct
  209.      upload agendas that reflect the best upload candidates that you have
  210.      available.
  211.  
  212.        RXFER employs scrolling lookup tables similar to those by Robocomm in its
  213.      Available Files and Downloaded Files databases.  In addition, RXFER has a
  214.      unique LOCATOR feature that allows you to position the lookup table
  215.      highlight bar on any file or BBS record stored in the database by typing
  216.      the first few characters of its name.
  217.  
  218.     Freeware RXfer                                                           vi
  219.      Copyright (c) 1992 Ronald J. Eisner
  220.      ___________________________________________________________________________
  221.  
  222.  
  223.      PROGRAM FEATURES
  224.      ----------------
  225.  
  226.  
  227.           Freeware RXfer has the following features:
  228.  
  229.           * FREE!  (Works with registered copies of Robocomm only.)
  230.           * Easy to use interface.
  231.           * Menu-driven.
  232.           * Automatic processing of Robocomm's TRANSFER.LOG.
  233.           * Context-sensitive on-line help.
  234.           * Lookup transfers by filename or by BBS.
  235.           * No practical limit on number of files in database (over two
  236.             billion).
  237.           * Scrolling lookup tables similar to those used by Robocomm in
  238.             its Files databases.
  239.           * Unique table Locator to quickly and interactively find ANY
  240.             file by typing just a few characters of the name.
  241.           * Data can be exported to ASCII.
  242.           * Uses extra RAM to cache its data files for faster perfor-
  243.             mance.
  244.           * Keeps details of each file transfer - such as date, time and
  245.             duration of transfer; number of errors; transfer protocol;
  246.             CPS; originating/destinating BBS.
  247.  
  248.  
  249.  
  250.      PROGRAM REQUIREMENTS
  251.      --------------------
  252.  
  253.  
  254.           Freeware RXfer has the following requirements:
  255.  
  256.           * 400K bytes disk space (program files) + about 25,000 bytes
  257.             per 100 transfers on file.
  258.           * 410K free RAM (any extra RAM is used to increase
  259.             performance).
  260.           * DOS 3.3 or higher (DR DOS 5.0/6.0 works fine).
  261.           * REGISTERED copy of ROBOCOMM 4.0 or higher.
  262.           * Installation in ROBOCOMM subdirectory.
  263.           * FILES=20 or greater.
  264.  
  265.           * Recommend a disk cache.
  266.           * Recommend an 80286 or better.
  267.           * RXfer works fine under QEMM (tm) & DESQview (tm).
  268.  
  269.     Freeware RXfer                                                          vii
  270.      Copyright (c) 1992 Ronald J. Eisner
  271.      ___________________________________________________________________________
  272.  
  273.  
  274.      DISTRIBUTION FILE LIST
  275.      ----------------------
  276.  
  277.  
  278.        Freeware RXfer includes or creates the following files:
  279.  
  280.  
  281.              ┌────────────────────────────────────────────────────────┐
  282.              │          FREEWARE RXFER DISTRIBUTION FILE LIST         │
  283.              ├──────────────┬─────────────────────────────────────────┤
  284.              │ RXFER.EXE    │  Main program executable.               │
  285.              ├──────────────┼─────────────────────────────────────────┤
  286.              │ RXFER.HLP    │  Context Sensitive Help file.           │
  287.              ├──────────────┼─────────────────────────────────────────┤
  288.              │ RXFER.DOC    │  Program Documentation (this file).     │
  289.              ├──────────────┼─────────────────────────────────────────┤
  290.              │ RXFER.NEW    │  New information.                       │
  291.              ├──────────────┼─────────────────────────────────────────┤
  292.              │ RXFER.FRM    │  Order form for Shareware RXfer Plus.   │
  293.              ├──────────────┼─────────────────────────────────────────┤
  294.              │ ANALYZE.FRX  │  Sample ANALYZE.BAT file to allow RXFER │
  295.              │              │  to be called from within Robocomm.     │
  296.              │              │                                         │
  297.              │              │  To use this, simply rename it to       │
  298.              │              │  ANALYZE.BAT - OR - incorporate it      │
  299.              │              │  into an existing ANALYZE.BAT           │
  300.              ├──────────────┼─────────────────────────────────────────┤
  301.              │ FILE_ID.DIZ  │  Description In ZIP file.               │
  302.              ├──────────────┼─────────────────────────────────────────┤
  303.              │ DESC.SDI     │  Another ZIP description file.          │
  304.              └──────────────┴─────────────────────────────────────────┘
  305.              ┌────────────────────────────────────────────────────────┐
  306.              │             FILES CREATED BY FREEWARE RXFER            │
  307.              ├──────────────┬─────────────────────────────────────────┤
  308.              │ RXFER.CFG    │  Configuration file.                    │
  309.              ├──────────────┼─────────────────────────────────────────┤
  310.              │ TRANSFER.001 │  TRANSFER.LOG ASCII "spill" file.       │
  311.              ├──────────────┼─────────────────────────────────────────┤
  312.              │ XFERBBS.DAT  │  BBS database and key files.            │
  313.              │ XFERBBS.K01  │                                         │
  314.              │ XFERBBS.K02  │                                         │
  315.              ├──────────────┼─────────────────────────────────────────┤
  316.              │ XFERFILE.DAT │  Files database and key files.          │
  317.              │ XFERFILE.K01 │                                         │
  318.              │ XFERFILE.K02 │                                         │
  319.              │ XFERFILE.K03 │                                         │
  320.              │ XFERFILE.K04 │                                         │
  321.              └──────────────┴─────────────────────────────────────────┘
  322.  
  323.  
  324.     Freeware RXfer                                                            1
  325.      Copyright (c) 1992 Ronald J. Eisner
  326.      ___________________________________________________________________________
  327.  
  328.  
  329.      INSTALLATION
  330.      ------------
  331.  
  332.  
  333.        Installation of Freeware RXfer is easy.  Simply copy all of the files
  334.      included with Freeware RXfer into your Robocomm subdirectory.  If you
  335.      received Freeware RXfer from a BBS in an archive format, simply un-archive
  336.      it into your Robocomm subdirectory.
  337.  
  338.      NOTE:  Freeware RXfer does not contain any files with names matching names
  339.             of Robocomm files - so there is no need to worry about overwriting
  340.             any Robocomm files.  If you are still concerned, compare the
  341.             Freeware RXfer Distribution File List (above) against the files in
  342.             your Robocomm subdirectory first to be sure.
  343.  
  344.  
  345.  
  346.      PROGRAM CONFIGURATION
  347.      ---------------------
  348.  
  349.  
  350.        There isn't any program configuration possible with Freeware RXfer.
  351.      (Shareware RXfer Plus has tons of configuration options.)
  352.  
  353.        The first time you run Freeware RXfer, a screen will be displayed that
  354.      explains how RXfer works.  RXfer will automatically process any existing
  355.      TRANSFER.LOG file each time it is run - EXCEPT the first time (or any
  356.      subsequent time if it does NOT find the file RXFER.CFG in the same subdi-
  357.      rectory - which indicates to RXFER that it is a first time run - see below.
  358.      If the file RXFER.CFG is erased then this condition will apply).
  359.  
  360.        The first time you run RXfer, the above is explained.  Next you choose to
  361.      allow or not allow RXfer to create RXFER.CFG.
  362.  
  363.        If you choose to NOT allow RXFER.CFG to be created, then the next time
  364.      you run RXFER it will again explain the above and again ask if you want to
  365.      create RXFER.CFG.  In other words, until you allow RXFER.CFG to be created,
  366.      the program will not do anything more than the above.
  367.  
  368.        Once you choose to allow RXFER.CFG to be created, RXFER will create the
  369.      file and then exit back to DOS.  It is now "configured".  Note that during
  370.      the initial run described above, where you choose to allow RXFER.CFG to be
  371.      created, RXFER will NOT process any existing TRANSFER.LOG file.
  372.  
  373.        Once configured, each time RXFER is run, if it finds an existing
  374.      TRANSFER.LOG, RXFER will process it.  Thus, the next time you run RXFER
  375.      after allowing RXFER.CFG to be created, your Robocomm TRANSFER.LOG file (if
  376.      any) will be processed.
  377.  
  378.        The reason RXFER requires you to allow it to create RXFER.CFG prior to it
  379.      doing any processing is that this author does not want any surprises to
  380.      take place.  In other words, until you explicitly allow RXFER to do its
  381.      work - it will not do anything.
  382.  
  383.     Freeware RXfer                                                            2
  384.      Copyright (c) 1992 Ronald J. Eisner
  385.      ___________________________________________________________________________
  386.  
  387.  
  388.      AUTOMATIC TRANSFER.LOG PROCESSING
  389.      ---------------------------------
  390.  
  391.  
  392.        Freeware RXfer automatically processes any existing TRANSFER.LOG each
  393.      time it is run.  What occurs during processing is described below.
  394.  
  395.  
  396.           1  For each record found in TRANSFER.LOG:
  397.  
  398.              1.1  The record is written out to the file TRANSFER.001.  This
  399.                   record is identical in format to the one read from
  400.                   TRANSFER.LOG.  (It is simply a copy of the record from
  401.                   TRANSFER.LOG.)
  402.  
  403.                   1.1.1  TRANSFER.001 exists as a "backup" of your Robocomm-
  404.                          created TRANSFER.LOG.  RXFER does not leave processed
  405.                          records in TRANSFER.LOG because to do so would cause
  406.                          RXfer to work through previously processed entries on
  407.                          subsequent runs.
  408.  
  409.                   1.1.2  TRANSFER.001 will keep "growing" in size as new
  410.                          TRANSFER.LOG files get processed.  RXFER does not prune
  411.                          this file for you.  You should occasionally prune
  412.                          TRANSFER.001 by archiving it and allowing a new one to
  413.                          start; or deleting it; or renaming it.  (RXFER PLUS has
  414.                          several automatic pruning options.)
  415.  
  416.                   1.1.3  TRANSFER.001 can be used to rebuild the RXfer database.
  417.                          If you rename TRANSFER.001 to TRANSFER.LOG and then
  418.                          delete the XFERFILE and XFERBBS database files and keys
  419.                          (see DISTRIBUTION FILE LIST, page vii), the next time
  420.                          you run RXfer it will recreate the databases from the
  421.                          TRANSFER.LOG file as if it were a normal TRANSFER.LOG
  422.                          file created by Robocomm.  You likely would have no
  423.                          reason to do this, but if you find the need the capa-
  424.                          bility is there.
  425.  
  426.              1.2  The file contained in the record is added to the files data-
  427.                   base file XFERFILE.DAT.
  428.  
  429.                   1.2.1  RXFER makes an attempt to recognize duplicate records
  430.                          in order to reduce redundant records in the database.
  431.                          If a record has the same filename, date & time of
  432.                          transfer to a BBS of another record in the database, it
  433.                          is considered a duplicate and is skipped.  Duplicates
  434.                          are spilled to TRANSFER.001.  (RXFER PLUS allows dupli-
  435.                          cates to be left out of TRANSFER.001.)
  436.  
  437.                   1.2.2  If the record is in a format not recognized by RXFER,
  438.                          it is ignored.  These records are spilled to
  439.                          TRANSFER.001.  (RXFER PLUS allows these record types to
  440.                          be spilled to a different file.)
  441.  
  442.     Freeware RXfer                                                            3
  443.      Copyright (c) 1992 Ronald J. Eisner
  444.      ___________________________________________________________________________
  445.  
  446.  
  447.              1.3  If a new BBS (not found in the database) is indicated in the
  448.                   record being processed, that BBS is added to the BBS database
  449.                   file XFERBBS.DAT.
  450.  
  451.           2  Once all records are processed, TRANSFER.LOG is deleted.
  452.  
  453.  
  454.  
  455.      LOOKING UP FILE TRANSFERS
  456.      -------------------------
  457.  
  458.  
  459.        Making previous file transfer lookups easy is RXfer's raison d'etre.
  460.  
  461.        RXFER allows you to look up by filename or by BBS.
  462.  
  463.  
  464.  
  465.      LOOKING UP FILE TRANSFERS BY FILENAME
  466.      -------------------------------------
  467.  
  468.  
  469.        From the RXFER Main Menu select FILE ACTIVITY to examine the file
  470.      transfer database.  The file activity table will appear.
  471.  
  472.  
  473.  
  474.      THE FILE ACTIVITY TABLE
  475.      -----------------------
  476.  
  477.  
  478.        The file activity table is sorted in alphabetical order.  Any files
  479.      transferred to more than one BBS will show a separate line for each BBS, in
  480.      BBS order.
  481.  
  482.     Freeware RXfer                                                            4
  483.      Copyright (c) 1992 Ronald J. Eisner
  484.      ___________________________________________________________________________
  485.  
  486.  
  487.        The following keys control movement and other actions within the file
  488.      activity table:
  489.  
  490.  
  491.          ┌───────────────────┬────────────────────────────────────────────┐
  492.          │                   │          FILE ACTIVITY TABLE KEYS          │
  493.          │                   │          (Same as BBS table keys)          │
  494.          │ ^ = <CTRL> key.   │                                            │
  495.          ├───────────────────┼────────────────────────────────────────────┤
  496.          │  <Arrow Keys>     │ Move highlight bar up/down one line.       │
  497.          │                   │ Table will scroll at top/bottom.           │
  498.          ├───────────────────┼────────────────────────────────────────────┤
  499.          │  <ENTER>          │ View Log Detail for highlighted record.    │
  500.          ├───────────────────┼────────────────────────────────────────────┤
  501.          │  <PgUp>           │ Scroll up one page.                        │
  502.          ├───────────────────┼────────────────────────────────────────────┤
  503.          │  <PgDn>           │ Scroll down one page.                      │
  504.          ├───────────────────┼────────────────────────────────────────────┤
  505.          │ ^<PgUp>           │ Move bar to first entry in database.       │
  506.          ├───────────────────┼────────────────────────────────────────────┤
  507.          │ ^<PgDn>           │ Move bar to last entry in database.        │
  508.          ├───────────────────┼────────────────────────────────────────────┤
  509.          │  <HOME>           │ Move bar to top of scroll area.            │
  510.          ├───────────────────┼────────────────────────────────────────────┤
  511.          │  <END>            │ Move bar to bottom of scroll area.         │
  512.          ├───────────────────┼────────────────────────────────────────────┤
  513.          │  <DELETE>         │ Delete highlighted record (you are         │
  514.          │                   │ prompted for confirmation).                │
  515.          ├───────────────────┴────────────────────────────────────────────┤
  516.          │                           LOCATOR KEYS                         │
  517.          ├───────────────────┬────────────────────────────────────────────┤
  518.          │ Alphanumeric      │ Build locator entry, dynamically moving    │
  519.          │ Keys; Punctuation │ highlight bar to find matching entry.      │
  520.          │  <BACKSPACE>      │ Delete one Locator character, move bar in  │
  521.          │                   │ reverse to record matching remaining por-  │
  522.          │                   │ tion of Locator entry.                     │
  523.          ├───────────────────┼────────────────────────────────────────────┤
  524.          │ ^<BACKSPACE>      │ Clear entire Locator, don't move bar.      │
  525.          ├───────────────────┼────────────────────────────────────────────┤
  526.          │  <ESC>            │ Exit table back to Main Menu.              │
  527.          └───────────────────┴────────────────────────────────────────────┘
  528.  
  529.  
  530.      THE LOCATOR
  531.      -----------
  532.  
  533.  
  534.        The RXfer Filename Locator allows you to quickly find any file in the
  535.      database simply by pressing the first few keys of the desired filename.
  536.  
  537.  
  538.  
  539.      USING THE LOCATOR
  540.      -----------------
  541.  
  542.     Freeware RXfer                                                            5
  543.      Copyright (c) 1992 Ronald J. Eisner
  544.      ___________________________________________________________________________
  545.  
  546.  
  547.        To use the Locator, you do not have to "select" it.  When in an RXfer
  548.      table, any alphabetic, numeric or punctuation key is considered to be a
  549.      Locator key and, when typed, is automatically displayed as part of the
  550.      Locator.  In other words, all non-movement and non-function keys are
  551.      Locator keys.
  552.  
  553.  
  554.  
  555.      FINDING FILES WITH THE LOCATOR
  556.      ------------------------------
  557.  
  558.  
  559.        To find a filename, simply begin typing its name.
  560.  
  561.        As you type each character into the Locator, the table's highlight bar
  562.      will move itself to the first database entry that matches what you have
  563.      typed in thus far.
  564.  
  565.        For example, if you type as the first character into the Locator the
  566.      letter "R", the table highlight bar will move itself to the first filename
  567.      beginning with the letter "R".  If you next type "O" (resulting in the
  568.      letters "RO" being within the Locator), the highlight bar will move to the
  569.      first filename beginning with the letters "RO".  If you then type "B"
  570.      (resulting in "ROB" in the Locator), the first filename beginning with
  571.      "ROB" will become highlighted.
  572.  
  573.        By the time you have typed in the example above, you are likely to have
  574.      found "ROBOCOMM" in the database - no matter how many filenames are in the
  575.      database!
  576.  
  577.        The general idea is that to find a particular filename, you only need to
  578.      type enough characters to uniquely identify it.
  579.  
  580.        If there is no entry matching what you have typed in, the highlight bar
  581.      will move to the closest filename FOLLOWING the place where the match would
  582.      be located.
  583.  
  584.  
  585.  
  586.      DELETING CHARACTERS FROM THE LOCATOR
  587.      ------------------------------------
  588.  
  589.  
  590.        At any time you can type the <BACKSPACE> key to delete the left-most
  591.      character in the Locator.  As soon as you do, the table highlight bar will
  592.      move in reverse to highlight the filename that matches what is left of the
  593.      Locator.
  594.  
  595.        You can press ^<BACKSPACE> at anytime to clear all the characters from
  596.      the Locator.  When you do this, the highlight bar will not move.  It will
  597.      remain on the filename highlighted at the time you pressed ^<BACKSPACE>.
  598.  
  599.     Freeware RXfer                                                            6
  600.      Copyright (c) 1992 Ronald J. Eisner
  601.      ___________________________________________________________________________
  602.  
  603.  
  604.      LOOKING UP FILE TRANSFERS BY BBS
  605.      --------------------------------
  606.  
  607.  
  608.        From the RXFER Main Menu select BBS ACTIVITY to examine the file transfer
  609.      database by specific BBS.  The BBS List table will appear.
  610.  
  611.        The BBS List is sorted in alphabetical order.
  612.  
  613.        From the BBS List, you can select the BBS for which you want to examine
  614.      file transfers.  The movement keys are the same as those for the File
  615.      Activity table (See THE FILE ACTIVITY TABLE, page 3), with two exceptions:
  616.      There is no Locator (because there will seldom be enough BBS entries to
  617.      warrant one); and pressing <ENTER> does not bring up a detail record.
  618.  
  619.        To examine all file transfers for a specific BBS, highlight the desired
  620.      BBS on the BBS List table and press <ENTER>.  A File Activity table showing
  621.      just the file transfers for the selected BBS will appear.
  622.  
  623.        The BBS List File Activity table works identically as the File Activity
  624.      table described above (See THE FILE ACTIVITY TABLE, page 3); except that
  625.      only files for the selected BBS are displayed.
  626.  
  627.  
  628.  
  629.      EXPORTING DATA
  630.      --------------
  631.  
  632.  
  633.        Freeware RXfer has an export data feature to allow you to extract the
  634.      information contained in its databases.  You can use this feature to create
  635.      a TRANSFER.LOG file that you want to provide to another copy of RXfer for
  636.      processing into its database (such as a home or work copy).
  637.  
  638.        If the RXfer (or RXfer Plus) file layout ever changes in a future
  639.      release, you may be requested to export the data from the old version prior
  640.      to beginning to use the new release.  This can serve as a method to convert
  641.      the old version data format into the new version's.
  642.  
  643.        Data is exported to an ASCII file named TRANSFER.LOG in the same subdi-
  644.      rectory as the RXfer program.  The export format is similar to the format
  645.      created by Robocomm when it writes to TRANSFER.LOG (the minor differences
  646.      are seen as identical by RXfer).
  647.  
  648.        Any existing TRANSFER.LOG is deleted by RXfer prior to beginning the
  649.      export of data.  However, it is not likely that will happen because RXfer
  650.      will have already processed and deleted any existing TRANSFER.LOG upon
  651.      startup.
  652.  
  653.        The TRANSFER.LOG file created by the export process can be used to
  654.      rebuild the RXfer database.  If you export the RXfer databases and then
  655.      delete the XFERFILE and XFERBBS database files and keys (see DISTRIBUTION
  656.      FILE LIST, page vii); the next time you run RXfer, it will recreate the
  657.  
  658.     Freeware RXfer                                                            7
  659.      Copyright (c) 1992 Ronald J. Eisner
  660.      ___________________________________________________________________________
  661.  
  662.  
  663.      databases from the export TRANSFER.LOG file as if it were a normal
  664.      TRANSFER.LOG file created by Robocomm.  You likely would have no reason to
  665.      do this, but if you find the need the capability is there.
  666.  
  667.        To export the RXfer databases, choose EXPORT TO TRANSFER.LOG from the
  668.      Main Menu.
  669.  
  670.        A window will appear that explain that any existing TRANSFER.LOG will be
  671.      overwritten.  You are given an opportunity to change your mind by selected
  672.      NO or proceeding by selecting YES from a menu.  The default response is
  673.      always NO so pressing <ENTER> without paying attention will simply exit you
  674.      back to the Main Menu.
  675.  
  676.        Select YES to begin the export process.
  677.  
  678.        A window will appear which displays the total number of records in the
  679.      database (this is the number to be exported) and an incrementing count of
  680.      the current number of records exported thus far.
  681.  
  682.        The export process is fast.  (On a 20Mhz 386 running under DESQview with
  683.      one other multi-tasking process running, exporting 200 records takes just
  684.      seven seconds.)
  685.  
  686.        Once the export process is complete, RXfer will prompt you to press any
  687.      key to return to the Main Menu.  Once you do press any key, the Main Menu
  688.      will indeed reappear.
  689.  
  690.  
  691.  
  692.      QUITTING RXFER
  693.      --------------
  694.  
  695.  
  696.        To quit RXfer and exit back to DOS (or whatever program called RXfer for
  697.      you), simply select QUIT PROGRAM from the Main Menu and press <ENTER>.
  698.      There is no confirmation for the Quit selection, so if you accidentally
  699.      quit, you'll just need to restart RXfer.
  700.  
  701.     Freeware RXfer                                                            8
  702.      Copyright (c) 1992 Ronald J. Eisner
  703.      ___________________________________________________________________________
  704.  
  705.  
  706.      TECHNICAL SUPPORT
  707.      -----------------
  708.  
  709.  
  710.        Even though Freeware RXfer is free, you can obtain technical support for
  711.      problems.  However, do not expect live operators, automated attendants, or
  712.      800-number service!
  713.  
  714.        Technical support is available these ways:
  715.  
  716.  
  717.        1 - Via the official support BBS:
  718.  
  719.              Planet X BBS
  720.              Sysop Tim Kilgore
  721.              Columbia MO
  722.              Node 1: 314-443-0319  USR HST/v.32 (public node)
  723.              Node 2: 314-442-0187  DIS v.32bis  (subscriber and new user node)
  724.              Node 3: 314-874-5887  (subscriber and new user node)
  725.              Wildcat! 3.02 BBS System (at this writing)
  726.              ASP Approved BBS
  727.  
  728.              After going through the New User requirements, you can <J>oin the
  729.              PCCS Support Conference and leave E-Mail to Ron Eisner (the au-
  730.              thor).  This was conference #6 at this writing - but that is
  731.              subject to change.  Check the conference list (by pressing <L>
  732.              AFTER selecting <J>oin from the main menu.  Ron checks in every
  733.              other day or so.
  734.  
  735.              You can also download free the latest version of Freeware RXfer
  736.              and Shareware RXfer Plus by accessing the PCCS Distribution &
  737.              Support file area (area 46 at this writing).  The filenames to
  738.              watch for are FRX???.ZIP (Freeware RXfer) and SRX???.ZIP
  739.              (Shareware RXfer Plus), where "???" represents the version
  740.              number.
  741.  
  742.              You may want to read the following Planet X bulletins after logging
  743.              on:
  744.  
  745.  
  746.                              System & General Information
  747.  
  748.                             1. About Planet ><
  749.                             2. Subscriber Information
  750.                             3. Security Levels used
  751.                             5. Free Files listing
  752.  
  753.  
  754.  
  755.        2 - Via Compuserve:
  756.  
  757.              Leave E-Mail to Ron Eisner at C.I.S. I.D. 74010,3011.  Ron checks
  758.              in to C.I.S. about once every other day.
  759.  
  760.     Freeware RXfer                                                            9
  761.      Copyright (c) 1992 Ronald J. Eisner
  762.      ___________________________________________________________________________
  763.  
  764.  
  765.  
  766.        3 - In writing:
  767.  
  768.              Please submit written requests for support, suggestions, and bug
  769.              reports to:
  770.  
  771.              PC CONSULTING SERVICES
  772.              PO BOX 30137
  773.              COLUMBIA  MO  65205-3137
  774.  
  775.              Please include your mailing address; and your telephone number in
  776.              case the author would like to reach you via voice.
  777.  
  778.  
  779.        The author also regularly monitors both the RIME and ILINK ROBOCOMM
  780.      conferences - but a response is NOT guaranteed.  However, it may be worth a
  781.      try.
  782.  
  783.  
  784.  
  785.      NEW VERSION AVAILABILITY
  786.      ------------------------
  787.  
  788.  
  789.        You can obtain free new releases of Freeware RXfer and Shareware RXfer
  790.      Plus from at least the two following BBS's:
  791.  
  792.        1 - Planet X BBS
  793.  
  794.              For access information, see TECHNICAL SUPPORT, page 8.
  795.  
  796.        2 - Group One BBS (Home of Robocomm)
  797.  
  798.              For access information, see your Robocomm BBS Directory or your
  799.              Robocomm documentation.
  800.  
  801.        The filenames to watch for are FRX???.ZIP (Freeware RXfer) and SRX???.ZIP
  802.      (Shareware RXfer Plus), where "???" represents the version number.
  803.  
  804.        Shareware RXfer Plus may also be ordered directly from PC Consulting
  805.      Services.
  806.  
  807.        Simply select PRINT ORDER FORM from the Main Menu (be sure your printer
  808.      is on line) to print a hardcopy order form with all the information
  809.      necessary for you to fill in.  Or, you can print out the file RXFER.FRM (an
  810.      ASCII file version of the order form).
  811.  
  812.        Send your order form, along with your check or money order, to PC
  813.      Consulting Services at the address on the order form (also listed above, on
  814.      page 9)
  815.  
  816.     Freeware RXfer                                                           10
  817.      Copyright (c) 1992 Ronald J. Eisner
  818.      ___________________________________________________________________________
  819.  
  820.  
  821.      SHAREWARE RXFER PLUS
  822.      --------------------
  823.  
  824.  
  825.        Shareware RXfer Plus is an enhanced version of RXfer that offers more
  826.      features and control.  It is available from the same sources as Freeware
  827.      RXfer (see New Version Availability, page 9).  The price is $16; which gets
  828.      you a registered copy of the current version on disk.  (Registered copies
  829.      display your registration number on screen and do not have any Shareware
  830.      "Nag" screens.)
  831.  
  832.            Shareware RXfer Plus is expected to be released in June, 1992.
  833.            Beta testing is currently underway.  If you pay for registra-
  834.            tion prior to its release, your payment will gain you access to
  835.            the beta testing process.  Beta versions are available on the
  836.            Planet X BBS in the PCCS Beta conference.  You will be sent the
  837.            current beta version on disk, along with a card with Planet X
  838.            access information, which will include a pre-registered beta-
  839.            only account in your name on the Planet X BBS and a password
  840.            (which you can change).  Your beta access will continue until
  841.            the beta testing is complete and during the beta period you may
  842.            call Planet X at any time to download the latest beta version.
  843.            Your feedback on any problems you encounter, or on any sugges-
  844.            tions you have, is welcomed and encouraged.  However, your
  845.            feedback will not be mandated.  Thus, if you do not want to
  846.            wait for RXfer Plus to be released, this can be an opportunity
  847.            to have early access to its features as they develop!
  848.  
  849.        Shareware RXfer Plus offers the following enhancements over Freeware
  850.      RXfer:
  851.  
  852.        *   Full statistics of your file transfer activities are maintained.
  853.            You can instantly see the total files and bytes uploaded and
  854.            downloaded from each BBS in the database.  Total time spent
  855.            transferring is also kept; along with your upload/download ratio,
  856.            among other stats.
  857.  
  858.        *   Command line operation allows you to look up file or BBS activity
  859.            from within Robocomm.  For example, you highlight a filename in
  860.            the Robocomm Downloaded Files database, press [F5] (the Robocomm
  861.            hot key that calls RXfer Plus) and have RXfer Plus show you to
  862.            where you have transferred that specific file.  This makes
  863.            lookups very easy and convenient!  Usable sample batch files
  864.            included.
  865.  
  866.        *   Automatic aging of the database according to your preferences.
  867.  
  868.        *   Printed reports of upload candidates; BBS statistics; more.
  869.  
  870.        *   Batch processing of Robocomm's TRANSFER.LOG allows you add files
  871.            to the RXfer Plus database automatically after every agenda.
  872.            Usable sample batch files included.
  873.  
  874.     Freeware RXfer                                                           11
  875.      Copyright (c) 1992 Ronald J. Eisner
  876.      ___________________________________________________________________________
  877.  
  878.  
  879.        *   Multiple "spill" files!  Automatic aging of spill files.  Can be
  880.            auto-named TRANSFER.001 up to TRANSFER.099, with selectable
  881.            maximum size.  Unrecognized log entries can be spilled to a
  882.            different file (user nameable - default TRANSFER.U01).
  883.  
  884.        *   Program can be located in ANY subdirectory.  You tell it where to
  885.            look for TRANSFER.LOG and ROBOCOMM.
  886.  
  887.        *   User-nameable data export filename.
  888.  
  889.        *   Plenty of configuration and customization options.
  890.  
  891.        *   A registered copy of Robocomm is not required to run RXfer Plus.
  892.  
  893.     Freeware RXfer
  894.      Copyright (c) 1992 Ronald J. Eisner
  895.      ___________________________________________________________________________
  896.  
  897.  
  898.      INDEX
  899.      -----
  900.  
  901.  
  902.      ^<BACKSPACE>  4, 5
  903.      ^<PGDN>  4
  904.      ^<PGUP>  4
  905.      <ARROW KEYS>  4
  906.      <BACKSPACE>  4, 5
  907.      <DELETE>  4
  908.      <END>  4
  909.      <ENTER>  4, 6, 7
  910.      <ESC>  4
  911.      <HOME>  4
  912.      <PGDN>  4
  913.      <PGUP>  4
  914.      ALPHANUMERIC KEYS  4
  915.      ANALYZE.FRX  vii
  916.      ARCHIVE FORMAT  v, 1
  917.      AUTHOR
  918.           (see also Eisner, Ron)  iii, iv, v, 1, 8, 9
  919.      AUTOMATIC TRANSFER.LOG PROCESSING  2
  920.      BBS  iv, v, vi, vii, 1-4, 6, 8-10
  921.      BBS ACTIVITY  6, 10
  922.      BBS LIST  6
  923.      Beta testing
  924.           Shareware RXfer Plus  10
  925.      CLEAR ENTIRE LOCATOR  4
  926.      COMPUSERVE
  927.           (Technical Support)  8
  928.      CONFIGURATION  vii, 1, 11
  929.      DELETE HIGHLIGHTED RECORD  4
  930.      DELETE ONE LOCATOR CHARACTER  4
  931.      DELETING CHARACTERS FROM THE LOCATOR  5
  932.      DESC.SDI  iv, vii
  933.      DESQVIEW  vi, 7
  934.      DISCLAIMER OF WARRANTY  iii
  935.      DISTRIBUTION FILE LIST
  936.           (see also FILES)  iv, vii, 1, 2, 6
  937.      DOS  vi, 1, 7
  938.      DR DOS  vi
  939.      DUPLICATE RECORDS  2
  940.      EISNER, RON
  941.           (author)  i, iv, 8
  942.      EXIT BACK TO DOS  1, 7
  943.      EXIT TABLE  4
  944.      EXPORT TO TRANSFER.LOG  7
  945.      EXPORTING DATA  6
  946.      FEATURES  vi, 10
  947.      FILE TRANSFERS  v, 3, 6
  948.      FILE_ID.DIZ  iv, vii
  949.      FILENAME LOCATOR  4
  950.      FILES
  951.  
  952.     Freeware RXfer
  953.      Copyright (c) 1992 Ronald J. Eisner
  954.      ___________________________________________________________________________
  955.  
  956.  
  957.           ANALYZE.FRX  vii
  958.           DESC.SDI  iv, vii
  959.           DISTRIBUTION FILE LIST  iv, vii, 1, 2, 6
  960.           FILE_ID.DIZ  iv, vii
  961.           RXFER.CFG  vii, 1
  962.           RXFER.DOC  vii
  963.           RXFER.EXE  vii
  964.           RXFER.FRM  vii, 9
  965.           RXFER.HLP  vii
  966.           RXFER.NEW  vii
  967.           TRANSFER.001  vii, 2, 11
  968.           TRANSFER.LOG  v, vi, vii, 1-3, 6, 7, 10, 11
  969.           XFERBBS  v, vii, 2, 3, 6
  970.           XFERFILE  v, vii, 2, 6
  971.      FILES CREATED BY FREEWARE RXFER  vii
  972.      FILES=20  vi
  973.      FINDING FILES WITH THE LOCATOR  5
  974.      FREE RAM  vi
  975.      FREEWARE  i, iii, iv, v, vi, vii, 1, 2, 6, 8-10
  976.      GROUP ONE BBS (HOME OF ROBOCOMM)  9
  977.      HIGHLIGHT BAR  v, 4, 5
  978.      INSTALLATION  vi, 1
  979.      KEYS  2, 4-6
  980.      LICENSE AGREEMENT  iv
  981.      LIMITS OF LIABILITY  iii
  982.      LOCATOR  v, vi, 4-6
  983.      LOG DETAIL  4
  984.      LOOKING UP FILE TRANSFERS  3, 6
  985.      LOOKING UP FILE TRANSFERS BY BBS  6
  986.      LOOKING UP FILE TRANSFERS BY FILENAME  3
  987.      NEW VERSION AVAILABILITY  9, 10
  988.           Group One BBS (Home of Robocomm)  9
  989.           PC CONSULTING SERVICES  9
  990.      OPTIONS  1, 2, 11
  991.      ORDER FORM  vii, 9
  992.      PC CONSULTING SERVICES
  993.           (Technical Support, Ordering)  9
  994.      PLANET X BBS
  995.           (Technical Support)  8-10
  996.      PRINT ORDER FORM  9
  997.      PROGRAM
  998.           CONFIGURATION  1
  999.           FEATURES  vi
  1000.           REQUIREMENTS  vi
  1001.      PUNCTUATION  4, 5
  1002.      QEMM  vi
  1003.      QUIT PROGRAM  7
  1004.      QUITTING RXFER  7
  1005.      REGISTERED COPY OF ROBOCOMM  iv, vi, 11
  1006.      REQUIREMENTS  vi, 8
  1007.      ROBOCOMM  i, iv, v, vi, vii, 1, 2, 5-7, 9-11
  1008.      RXFER PLUS  vii, 1, 2, 6, 8-11
  1009.      RXFER.CFG  vii, 1
  1010.  
  1011.     Freeware RXfer
  1012.      Copyright (c) 1992 Ronald J. Eisner
  1013.      ___________________________________________________________________________
  1014.  
  1015.  
  1016.      RXFER.DOC  vii
  1017.      RXFER.EXE  vii
  1018.      RXFER.FRM  vii, 9
  1019.      RXFER.HLP  vii
  1020.      RXFER.NEW  vii
  1021.      SCROLL DOWN ONE PAGE  4
  1022.      SCROLL UP ONE PAGE  4
  1023.      SHAREWARE  vii, 1, 8-10
  1024.      SHAREWARE RXFER PLUS  vii, 1, 8-10
  1025.           AVAILABILITY  10
  1026.           Beta testing  10
  1027.           FEATURES  10
  1028.           ORDERING  9
  1029.      SUBDIRECTORY  vi, 1, 6, 11
  1030.      TABLE KEYS  4
  1031.      TABLE OF CONTENTS  ii
  1032.      TECHNICAL SUPPORT  8, 9
  1033.           Compuserve  8
  1034.           ILINK  9
  1035.           In writing  9
  1036.           PC CONSULTING SERVICES  9
  1037.           Planet X BBS  8-10
  1038.           RIME  9
  1039.      THE FILE ACTIVITY TABLE  3, 4, 6
  1040.      THE LOCATOR  4, 5
  1041.      TRANSFER.001  vii, 2, 11
  1042.           prune  2
  1043.      TRANSFER.LOG  v, vi, vii, 1-3, 6, 7, 10, 11
  1044.      USING THE LOCATOR  4
  1045.      WARRENTY
  1046.           DISCLAIMER OF WARRANTY  iii
  1047.      WHAT IS RXFER?  v
  1048.      XFERBBS  v, vii, 2, 3, 6
  1049.      XFERFILE  v, vii, 2, 6
  1050.  
  1051.